home *** CD-ROM | disk | FTP | other *** search
/ Aminet 49 / Aminet 49 (2002)(GTI - Schatztruhe)[!][Jun 2002].iso / Aminet / dev / misc / FlexCat.lha / FlexCat.readme < prev   
Text File  |  2002-03-19  |  6KB  |  132 lines
  1. Short:    2.5b - Flexible catalogs (C, Asm, Oberon, E, ARexx, Modula...)
  2. Author:   Marcin Orlowski <carlos@amiga.com.pl>
  3. Uploader: Marcin Orlowski <carlos@amiga.com.pl>
  4. Type:     dev/misc
  5. Version:  2.5b
  6. WWW:      http://amiga.com.pl/flexcat/
  7. Date:     Tue Mar 19 00:56:58 2002
  8.  
  9.  
  10.  
  11.   INFO
  12.   ----------
  13.  
  14.     FlexCat creates catalogs and the source to handle them.  The difference
  15.   between FlexCat and KitCat, CatComp and some others is, that FlexCat is
  16.   designed to produce any source you want:  any programming language, any
  17.   individual needs should be satisfied.  However, FlexCat is not more
  18.   difficult to use.
  19.  
  20.     Translators will also find it useful, as, among standard functions
  21.   like #?.catalog creation, FlexCat is able to update your #?.ct files
  22.   to the new #?.cd files automatically. Give it a try! 
  23.  
  24.     This sounds like a contradiction.  FlexCat's solution is to use
  25.   template files, the so called "source descriptions".  Ready to use examples
  26.   for Assembler, C, C++, E, Oberon and Modula-2 are distributed, additionally
  27.   an example for supporting catalogs on Workbench 2.0.  Any other examples
  28.   are welcome.
  29.  
  30.  
  31.   Archives
  32.   ----------
  33.  
  34.     Since release 2.0, the FlexCat distribiution is splitted into the
  35.   smaller archives. They are (in order of importance):
  36.  
  37.   FlexCat.lha           - Latest FlexCat, user contribitions, english manual
  38.                          and foreign catalog files
  39.  
  40.   FlexCat_0x0.lha       - patches for 020, 040 and 060 versions of FlexCat
  41.                          (PPC makes no sense here. I checked that).
  42.  
  43.   FlexCat_ExDocs.lha    - FlexCat's guide in non english languages. Currently
  44.                          Svenska, Espanol and Deutsch are provided
  45.  
  46.   FlexCat_CatSrc.lha    - #?.cd and #?.ct files for existing translations and
  47.                          #?.texinfo documents
  48.  
  49.   FlexCat_Src.lha       - C source code for the FlexCat itself
  50.  
  51.   FlexCat_Demos.lha     - example source codes -> shows how to make localized
  52.                           programs using FlexCat (C/HSPascal/ARexx/etc)
  53.  
  54.                           NOTE: I would gladly welcome examples for other
  55.                           languages (E/Asm etc) as well as detailed tutorials 
  56.                           about right way of doing localized software.
  57.                           Your contribution is highly welcome!
  58.  
  59.  
  60.   If you just want to use FlexCat, the 1st archive is all you need.
  61.   If you want to have CPU optimised binaries, take both 1st and 2nd
  62.   and patch the original release.  If you want to read translated manual,
  63.   get the 3rd one.  If you want to make the translation take the 4th one
  64.   (but I suggesto to join the Amiga Translators' Organisation
  65.   <http://ato.vapor.com/ato> first!)
  66.  
  67.  
  68.   Changes since previous release:
  69.   -------------------------------
  70.   * v2.5b (19.03.02)- Added GG patchfile, thanks to Martin Blom <martin@blom.org>
  71.  
  72.  
  73.   * v2.5 (14.02.02) - Fixed the problem, if using $TODAY, that the date was
  74.                       one day ahead (tomorrow ;). Replaced gmtime() with
  75.                       localtime() (DMX).
  76.  
  77.  
  78.   * v2.4 (28.11.99) - FlexCat is now portable! Thanks to Hardcode.sd{tm}
  79.                       unique technology you can now try to compile FlexCat
  80.                       under any OS (both Big and Little Endians are
  81.                       supported). Read developer.readme for details.
  82.  
  83.                     - sometimes garbage could be written instead of
  84.                       $VER: string (when $TODAY feature was used) due
  85.                       to memory block being free'd before write.
  86.  
  87.                     - added ##rem command to .sd file handling. As you
  88.                       have probably guessed, it's just remark. The goal
  89.                       (at least for me) is that ##rem lines won't appear
  90.                       in result source code, creaded out of the .sd file.
  91.  
  92.                     - added manual catalog open/close for compilers that
  93.                       do not handle autoinit/exit functions
  94.  
  95.                     - Updated french translation (Herve Dupont
  96.                       <herve.dupont@nordnet.fr>)
  97.  
  98.                     - Added NOSPACE switch, to avoid extra space char
  99.                       usually used by FlexCat to separate comment
  100.                       mark ';' from the main comment text
  101.  
  102.                     - Source descriptor for HSPascal by Artur Karpunin
  103.                       <woody8@kki.net.pl> is now available.
  104.  
  105.                     - New archive "FlexCat_Demos" full ;-) of example
  106.                       source codes for various programming languages
  107.                       C, HSPascal and ARexx examples are recently
  108.                       available.
  109.  
  110.                     - Content of "Contribution" drawer is now moved to
  111.                       "FlexCat_Demos" archive.
  112.  
  113.                     - Added detailed tutoral (in polish for now) about
  114.                       the whole localization process (incl. examples)
  115.  
  116.  
  117.   * v2.3 (19.05.99) - "Trailing ellipsis" detector was broken (Marco
  118.                       De Vitis <marco.dvv@flashnet.it>)
  119.  
  120.                     - Seems I updated the english manual for v2.2, but
  121.                       forgot to create .guide file out of texinfo.
  122.  
  123.                     - Fixed manual to say "1999" instead of "1998", and
  124.                       fixed #?.cd file to show proper arguments when
  125.                       help ("?") is requested (Herve Dupont
  126.                       <herve.dupont@nordnet.fr>)
  127.  
  128.                     - Spanish translation by Sergio Martín Rodríguez
  129.                       <smartin@kaos.es> and Tomás J. Cantó
  130.                       <tjcanto@redestb.es>
  131.  
  132.